home *** CD-ROM | disk | FTP | other *** search
/ Aminet 35 / Aminet 35 (2000)(Schatztruhe)[!][Feb 2000].iso / Aminet / util / wb / ProcessIcon.readme < prev    next >
Text File  |  2000-01-02  |  7KB  |  142 lines
  1. Short:    V1.19 CLI tool to manipulate icon data
  2. Author:   stoecker@amigaworld.com (Dirk Stoecker)
  3. Uploader: stoecker@amigaworld.com (Dirk Stoecker)
  4. Version:  1.19
  5. Type:     util/wb
  6. Kurz:     CLI Programm zum Aendern von Icon-Daten
  7.  
  8. ProcessIcon needs OS 37 (2.0) or later OS versions!
  9.  
  10. Usage:
  11.   ProcessIcon ICON/A,REFICON,VIEW/S,OPT=OPTIMIZE/S,US=UNSNAP/S,REMAP/S
  12.   SHOWTYPE/S,NI2CI/S,MWB2CI/S,II2CI/S,MAKECI/S,
  13.  
  14.   SBP=SETBITPLANES/N,SDT=SETDEFTOOL,SIT=SETICONTYPE,SSS=SETSTACKSIZE/N,
  15.   ST1=SETTRANSPARENT1/N,ST2=SETTRANSPARENT2/N,SXP=SETXPOS/N,SYP=SETYPOS/N,
  16.   
  17.   KCI=KILLCOLORICON/S,KDD=KILLDRAWERDATA/S,KDT=KILLDEFTOOL/S,
  18.   KII=KILLICONIMAGE/S,KNI=KILLNEWICON/S,KSS=KILLSTACKSIZE/S,
  19.   KTT=KILLTOOLTYPES/S,
  20.   
  21.   CDD=COPYDRAWERDATA/S,CDT=COPYDEFTOOL/S,CII=COPYICONIMAGE/S,
  22.   CIT=COPYICONTYPE/S,CNI=COPYNEWICON/S,CSS=COPYSTACKSIZE/S,
  23.   CTT=COPYTOOLTYPES/S:
  24.  
  25. A lot of options :-) When you need some more, please contact me. It is
  26. most time really easy to implement them!
  27.  
  28. ICON     The icon you want to manipulate. When it does not exist, it is
  29.          created (works only, when at least a drawer or file of that name
  30.          exists.).
  31. REFICON  Reference icon for copy options.
  32. VIEW     Show some information about ICON. Any other options are disabled by
  33.          this one.
  34. OPT      Remove useless stuff in ICON (f.e. DrawerData for Project-Icons).
  35. UNSNAP   Removes position information of ICON. This can be done with
  36.          Workbench menu as well.
  37. REMAP     Switches fore- and background color when only 1 bitplane or
  38.          color 2 and 3 (black and white) for 2 and more bitplanes. This is
  39.          to support those old OS1.3 style icons still appearing sometimes.
  40. SHOWTYPE Only show icon type and name in one line. Any other options are
  41.          disabled by this one.
  42.  
  43. NI2CI     Converts NewIcon images to OS3.5 icon data.
  44. MWB2CI     Converts MagicWB icons to OS3.5 icons with correct palette.
  45. II2CI     Convert standard icons to OS3.5 icon data. Useful for later
  46.      modification.
  47. MAKECI     This equals II2CI for old style icons and "NI2CI KNI" for new icons.
  48.      For icons with NewIcon and OS3.5 data it means "KNI". It is useful
  49.      to add KII and OPT keyword to reduce size.
  50.  
  51. SBP Set number of bitplanes. Reducing number of bitplanes may make older
  52.     icons look better.
  53. SDT Set default tool of ICON.
  54. SIT Set type of ICON. Allowed types are: "Disk", "Drawer", "Tool",
  55.     "Project", "Garbage", "Device", "Kick" and "AppIcon".
  56. SSS Set the stack size to any value.
  57. ST1 Set transparent color 1 of OS3.5 data (-1 == no transparency)
  58. ST2 Set transparent color 2 of OS3.5 data (-1 == no transparency)
  59. SXP Set left position of ICON.
  60. SYP Set upper position of ICON.
  61.  
  62. KCI Kills OS3.5 color icon data.
  63. KDD Kill DrawerData in ICON. This does delete drawer data for tool and
  64.     project icons. For drawers and disks the data is not deleted, but
  65.     replaced by default data.
  66. KDT Delete default tool in ICON.
  67. KII Replace icon image with that 5x5 box used by NewIcons. This option
  68.     also sets bitplanes to 3, so you cannot use SBP option.
  69. KNI Delete NewIcon images from ICON.
  70. KSS Set Stacksize in ICON to 0 (this is default and used as size 4096).
  71. KTT Remove ToolTypes from ICON, but leave NewIcon image intact.
  72.  
  73. CCI Copy OS3.5 color icon data from REFICON to ICON.
  74. CDD Copy DrawerData from REFICON to ICON. This size, position and view
  75.     state of a drawer window (not of the icon). Only useful for drawers.
  76. CDT Copy default tool from REFICON to ICON. Only useful for Project icons.
  77. CII Copy the image (or maybe two images) from REFICON to ICON. This
  78.     also affects the icon position. The position is changed in a way,
  79.     so that the icon text appears at same position as before.
  80. CIT Copy the icon type from REFICON to ICON.
  81. CNI Copy NewIcon image from REFICON to ICON.
  82. CSS Copy Stacksize form REFICON to ICON.
  83. CTT Copy ToolTypes from REFICON to ICON (but ignore NewIcon image stuff).
  84.  
  85. Beginning with version 1.13 the program no longer treats NewIcon data as
  86. ToolTypes! CTT and KTT only affect the tooltypes and CNI and KNI only
  87. affect the NewIcon image data (which are in real tooltypes as well).
  88. Since version 1.14 OS3.5 icons are handled correctly.
  89.  
  90. Some notes:
  91.   Starting with OS3.5, stacksizes below 4096 are always raised to value 4096.
  92.   This also affects KSS-Option.
  93.  
  94.   If the copy arguments are used and there is no such data in REFICON, the
  95.   argument equals the function of kill arguments (replace by nothing).
  96.  
  97.   If an icon contains both NewIcon and OS3.5 stuff, after modifications the
  98.   OS3.5 stuff disappears.
  99.  
  100.   All the CI options need OS3.5 running.
  101.  
  102. ! Using this tool with OS3.5 icons without running OS3.5 destroys the color
  103. ! image information of the icons. Also OS3.5 icons cannot be detected without
  104. ! running OS 3.5.
  105.  
  106. I myself use option CII to replace various text, guide or drawer icons with
  107. my default icons without losing icon positions and DrawerData. This is done
  108. by a click on a DirWork button. (For DirOpus users it should be easy as
  109. well).
  110.  
  111. Please report me bugs, comments, suggestions and problems. If possible
  112. write a little mail if you use the program sometimes. If there are some
  113. Enforcer hits or other problems report them as good as possible.
  114.  
  115. Use it as you want, but WITHOUT ANY WARRANTY!
  116.  
  117. Please contact me:
  118.  
  119. ************************************************************************
  120. * snail-mail:                  * e-mail:                               *
  121. *   Dirk Stoecker              *   stoecker@amigaworld.com             *
  122. *   Geschwister-Scholl-Str. 10 *   dstoecker@gmx.de                    *
  123. *   01877 Bischofswerda        * world wide web:                       *
  124. *   GERMANY                    *   http://home.pages.de/~Gremlin/      *
  125. * phone:                       * pgp key:                              *
  126. *   GERMANY +49 (0)3594/706666 *   get with finger or from WWW pages   *
  127. ************************************************************************
  128.  
  129.  
  130. ============================= Archive contents =============================
  131.  
  132. Original  Packed Ratio    Date     Time    Name
  133. -------- ------- ----- --------- --------  -------------
  134.     8356    4938 40.9% 06-Dec-99 13:41:36  ProcessIcon
  135.     5892    2555 56.6% 06-Dec-99 13:41:36  ProcessIcon.readme
  136.     2188     805 63.2% 06-Dec-99 13:41:36 +SDI_ASM_STD_functions.lib
  137.     5632    1977 64.8% 06-Dec-99 13:41:36 +SDI_ASM_STD_protos.h
  138.     3713    1610 56.6% 06-Dec-99 13:41:36 +SDI_defines.h
  139.    27769    6646 76.0% 06-Dec-99 13:41:36 +ProcessIcon.c
  140. -------- ------- ----- --------- --------
  141.    53550   18531 65.3% 07-Dec-99 19:15:48   6 files
  142.